home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / BRODIE / ARCWEB / ARCWEB_1 / ReadMe1st! < prev    next >
Text File  |  1997-09-19  |  16KB  |  405 lines
  1. ArcWeb 1.92 Release Notes
  2. =========================
  3.  
  4. Read this file very carefully - ArcWeb MAY NOT WORK unless you do.
  5. I know it seems like a lot of instructions, but the length is mostly
  6. due to me going into as much detail as I can to try to pre-empt any
  7. problems.  You should find that you can skim through most sections.
  8.  
  9. If you are reading this from a CD, then it is almost certainly out of
  10. date, and you should check the primary sources to see what the latest
  11. version is.
  12.  
  13. Contents items marked '!!' indicate that this item was changed recently
  14. and should be re-read.
  15.  
  16. Changes in this version are documented in the ChangeLog file.
  17.  
  18. *** READ THE INSTALLATION SECTION BELOW FOR DETAILS ********
  19.  
  20. Contents:
  21.      Installation            Usage with Acorn TCP/IP
  22.     Usage with ANT !InetSuite    Usage with ImageFS 2
  23.     Usage with Virtualise        Usage with RISC OS 3.7
  24.     'Viewing' audio files        Viewing video files
  25.     Installing new sprite sets    Installing new template sets
  26.     YOUR Personal Privacy        ArcWeb Mailing Lists
  27.     Where to get it all        Bugs in this version
  28.     Support                Miscellaneous Information
  29.  
  30.  
  31.  
  32. *** Almost certainly will not work over KA9Q (although it might)
  33. *** Use FreeNet or Acorn TCP/IP (version 2.11 or version 4.06 or later)
  34.  
  35. All documents referenced in all the files here which say that the file
  36. is in the archive root, should be taken as meaning "either in the archive
  37. root, or inside ReadmeDocs directory in the archive root".
  38.  
  39. ArcWeb requires several Acorn modules to be present in order to run. All
  40. will be found inside the toolbox.arc archive to be found in the same
  41. location as the ArcWeb archive.  This is contrary to the comments in some
  42. files that refer to the modules being included "with this archive".
  43. Further details below.
  44.  
  45. ArcWeb is fully StrongARM compatible.
  46.  
  47.  
  48. Copyrights
  49. ==========
  50.  
  51. The !Scrap, !System & !SysMerge directories & Toolbox modules contained
  52. within that !System are copyright (C) Acorn Computers Ltd.
  53.  
  54. !FilerURLs is copyright (C) 1995, Acorn Computers Ltd. All rights reserved.
  55.  
  56. This program contains code derived from the RSA Data Security, Inc.
  57. MD5 Message-Digest Algorithm.
  58.  
  59. This software is based in part on the work of the Independent JPEG Group.
  60. The JPEG library code is Copyright (C) 1991-1996, Thomas G. Lane
  61. and the Independent JPEG Group
  62.  
  63. The PNG support library (libpng) is copyright (c) 1995, 1996
  64.    Guy Eric Schalnat, Group 42, Inc.
  65.    Contributing Authors:    Andreas Dilger    Dave Martindale
  66.     Guy Eric Schalnat    Paul Schmidt    Tim Wegner
  67.  
  68. The GIF support library (gifstream) and gif2spr are copyright (C) 1995,
  69. Simon Truss.
  70.  
  71.  
  72. Installation
  73. ============
  74.  
  75. *** You must not install this version over versions prior to 1.13 <------
  76.  
  77. Updating the modules in !System
  78. -------------------------------
  79.  
  80. Several Acorn modules are required to be present in !System in order for all
  81. the parts of ArcWeb to run.  All required modules are supplied in the now
  82. SEPARATE toolbox.arc archive.  You need to ensure that your !System directory
  83. is up to date, and once you have finished reading the whole of this section,
  84. you should REBOOT in order to kill any old versions which may be in memory.
  85. Failure to do so may cause things not to work as expected.  The modules
  86. to be found in toolbox.arc are those distributed with Acorn C/C++ update 1.
  87.  
  88. RISC OS 3.1x users should use !SysMerge (!SysMerge.!Help contains more
  89. details).  RISC OS 3.50 and later should run the !Boot application on the
  90. primary hard disc, and click on the System folder in the Configuration
  91. window.  Drag the toolbox.arc !System onto the window as prompted. (NOTE:
  92. Several people have reported that the RISC OS 3.50 and later upgrade facility
  93. does NOT work reliably.  So you may have to use !SysMerge instead)
  94.  
  95. The toolbox.arc !System also contains some toolbox support modules, which are
  96. used by the colour editor and the DNS tester.  ArcWeb is not itself a
  97. Toolbox application, just these utilities.
  98.  
  99. Unpacking the software
  100. ----------------------
  101.  
  102. The !WebHelper directory from versions 1.13 and before MUST be
  103. deleted, since it contains a lot things which are no longer required (in
  104. particular: !ArcWebTCP) If you do not do this, then you will be wasting 160K
  105. of memory which ArcWebTCP takes up, as that program is now integrated in
  106. ArcWeb itself.  (However, ArcWeb will send ArcWebTCP quit messages if it
  107. sees it loaded)
  108.  
  109. You should copy out the complete contents of the archive to a directory
  110. *close to the root directory* of a drive, and then reboot in order that
  111. the path variables point to the extracted versions rather than the
  112. copies in the archive.  (For reasons why it has to be close to the root,
  113. see 'Problems' Q18).
  114.  
  115. You may wish to edit your boot sequence to force FilterMgr 0.09 or later to
  116. be loaded at boot time, as sometimes it causes problems when you load it in
  117. the middle of a session, typically causing "Bad vector release" errors.  At
  118. this point, reboot - this is to ensure that the new versions of the modules
  119. are loaded from !System, and that the Filer sees the extracted version of
  120. !WebCache before any version inside an archive.  
  121.  
  122. When you run it for the first time, you should click MENU over ArcWeb's icon
  123. bar icon and look at the "Configure" submenu.  You should go through each
  124. entry on this menu in turn checking the configuration.  For more information
  125. on most of these windows, you can use Acorn's !Help for more information. The
  126. ChangeFSI submenu is something you probably don't want to fiddle with unless
  127. you know exactly what you are doing.  Then Save Options and quit and reload
  128. ArcWeb.
  129.  
  130. Fixing ChangeFSI
  131. ----------------
  132.  
  133. There are two alterations that you can make to ChangeFSI in order
  134. to allow it to handle some foreign graphics file formats better.  You
  135. need only do this if you are confident editing the ChangeFSI main
  136. program (it's written in BASIC) with the help of the detailed 
  137. instructions, **BUT** if you do not, then you will find that most of
  138. the JPEG images on the web will not be handled.
  139.  
  140.  
  141. You should ensure that you have fixed ChangeFSI appropriately.  See
  142. the file ChgFSI_fix for complete details on how to install the fix
  143. which will prevent "GIF file with , in the wrong place" errors.  If
  144. you have ChangeFSI 1.15 or later, you should not need to fix this.
  145.  
  146. You should also ensure that you have applied the changes to ChangeFSI
  147. as documented in ReadMeDocs.JPEG_Fix in order to enable it to handle
  148. progressive JPEG images.  The fix documents the changes to ChangeFSI
  149. version 1.15 only, but should be similar for earlier versions.
  150.  
  151.  
  152. Finally
  153. -------
  154.  
  155. Now read the 'Instruct' file - particular about Installation. Read the file
  156. called "Problems" if you still have trouble. For conditions of use, please
  157. read Terms.
  158.  
  159.  
  160. Usage with Acorn TCP/IP
  161. =======================
  162.  
  163. RISC OS 3.70 users have the necessary Acorn TCP/IP modules in ROM.  For
  164. earlier versions, if you want to use the Acorn TCP/IP software, then you
  165. can get this from: ftp://ftp.acorn.co.uk/pub/riscos/releases/networking/DCI4/
  166. or http://www.acorn.co.uk/ftp/riscos/releases/networking/DCI4/
  167.  
  168. There is a free DCI4 SLIP driver available at:
  169. http://freenet.barnet.ac.uk/freenet/
  170. in the Tom Hughes section.
  171.  
  172. The is also a shareware DCI4 PPP driver available at:
  173. http://freenet.barnet.ac.uk/freenet/
  174. in the Sergio Monesi section.
  175.  
  176.  
  177. Usage with ANT !InetSuite
  178. =========================
  179.  
  180. If you are using RISC OS based web browsers for HTML authoring, it is
  181. a good idea to check your HTML with as many browsers as possible.  Since
  182. ANT have used a compatible TCP/IP stack for their Internet Suite, ArcWeb
  183. will run on top of it too.  You should not need to make any changes.
  184.  
  185.  
  186. Usage with ImageFS 2
  187. ====================
  188.  
  189. This version of ArcWeb can co-operate with ImageFS 2 in order to provide fast
  190. foreign image conversions.   Simply load ImageFS and ensure that it is setup
  191. to handle the various foreign file types automatically.  (This only works for
  192. bitmap conversions - not vector conversions)
  193.  
  194. ImageFS 2 is a product of Alternative Publishing Ltd., who may be contacted
  195. by sending e-mail to sales@apsoft.webscotland.co.uk.  From reports I have
  196. had from my beta testers, it would seem to be a good product.  I have no
  197. connection with that company.  All trademarks acknowledged.
  198.  
  199.  
  200. Usage with Virtualise
  201. =====================
  202.  
  203. ArcWeb will look for the presence of RISC OS 3.50 or later, and use a
  204. dynamic area for its page store automatically.  You can control the
  205. maximum size of this dynamic area by changing the size in the Memory
  206. configuration window.  The size takes effect when ArcWeb is next
  207. restarted (if you Save Options!).
  208.  
  209. The dynamic area can be made virtual by changing the option in the
  210. bottom part of this window.  This takes effect when you press 'Set',
  211. and is handled automatically for you.  If you use the Virtualise front
  212. end to virtualise ArcWeb's DA, then you may run into problems with this
  213. switch, so don't do it - you don't need to fiddle with it there!
  214.  
  215. Virtualise was written by Alexander Thoukydides (thouky@tcp.co.uk).
  216. The marketing rights belong to Clares Micro Supplies.   For more details on
  217. Virtualise, you should send e-mail sales@clares.demon.co.uk.  I have no
  218. connection with the author or that company, except as a satisfied customer.
  219. All trademarks acknowledged.
  220.  
  221. !! If you are using Virtualise on RISC OS 3.7, then read the next section
  222. carefully if you have trouble with the font blending:
  223.  
  224. Usage with RISC OS 3.70 
  225. =======================
  226.  
  227. ArcWeb supports the font blending which is new in RISC OS 3.70.  This
  228. facility can be controlled from the Browser configuration window. You will
  229. need a suitable Font Manager to this to work.  The setting will be ignored if
  230. your Font Manager can't handle it.
  231.  
  232. !! If you find that all the text comes out black and unreadable (and it
  233. affects other applications too) then the chances are that you have tried
  234. to virtualise the InverseTable dynamic area.  You must not make this D.A.
  235. virtual otherwise it causes the problem described.
  236.  
  237.  
  238. "Viewing" Audio files
  239. =====================
  240.  
  241. If you want to hear audio, then you will require SoundCon by Rick Hudson.
  242. Version 1.51 and later of SoundCon include support for the ArcWeb protocols
  243. and can be found at ftp://ftp.demon.co.uk/pub/acorn/sound/   or at
  244. ftp://micros.hensa.ac.uk/micros/arch/riscos/d/d044/
  245.  
  246. At the time of writing, SoundCon is at version 1.61
  247.  
  248. "RealAudio" (a trademark of Progressive Networks Inc.) is not supported.  It
  249. uses a proprietary algorithm to encode the audio transmission, details of
  250. which are not available freely at the time of writing.
  251.  
  252.  
  253. Viewing Video files
  254. ===================
  255.  
  256. If you want to see MPEGs then you need something like !MPEGPlay.  Lots of
  257. movie formats can be played by MovieFS.  Support is built in for
  258. MovieFS, and downloaded movies will be automatically played (by Replay).
  259.  
  260. MPEGplay is at ftp://micros.hensa.ac.uk/micros/arch/riscos/a/a258/
  261.  
  262. A *restricted playback* version of MovieFS is available freely from:
  263. ftp://ftp.comlab.ox.ac.uk/tmp/Robin.Watts/
  264.  
  265. "RealVideo" (a trademark of Progressive Networks Inc.) is not supported.  It
  266. uses a proprietary algorithm to encode the video transmission, details of
  267. which are not available freely at the time of writing.
  268.  
  269.  
  270. Installing new sprite sets
  271. ==========================
  272.  
  273. See the ReadMe1st inside the AltToolbar directory in the main distribution
  274. archive.
  275.  
  276.  
  277. Installing new template sets
  278. ============================
  279.  
  280. Don't.  Otherwise you may fail to upgrade properly when a new modified
  281. Template file is supplied and that will cause weird and wonderful
  282. crashes for no apparent reason.
  283.  
  284.  
  285. YOUR Personal Privacy
  286. =====================
  287.  
  288. Whilst the vast majority of public services provided on the Internet are
  289. provided for your benefit, there are sites cropping up that are working
  290. directly against your benefit.  These sites use various techniques to
  291. obtain information about you by tracking the sites that you visit.
  292. These people actually sell their service to junk mail generators and
  293. other advertisers so that they can profile YOU and send you advertising via
  294. e-mail (which in many cases *you* will be paying to download).  It is hard to
  295. prevent this, although knowing the sites that are engaged in this activity
  296. can help.  You can stop access to these sites by entering the domain name
  297. concerned in the !ArcWeb.Block file.
  298.  
  299. !!! NOTE: the Allow file contents OVERRIDE the Block file, so you must 
  300.           not have an Allow file containing "*" if you want to block
  301.           any sites at all.
  302.  
  303.  
  304. ArcWeb Mailing Lists
  305. ====================
  306.  
  307. As of April 1997, a mailing list is available to which you can subscribe
  308. and automatically receive announcements of new versions.  This is a low
  309. volume mailing list which is *moderated*.  Attempts to post to it will
  310. fail, although subscription is open to anybody (all subscriptions are
  311. vetted though to prevent spamming companies subscribing to the list and
  312. retrieving the membership lists).
  313.  
  314. To subscribe, send an e-mail to arcweb-announce-request@ecs.soton.ac.uk
  315. (the Subject is ignored) containing:
  316.  
  317. subscribe
  318.  
  319. To unsubscribe from the mailing list, use "unsubscribe" instead.  If you
  320. send the message via ArcWeb, please ensure that you have set up your
  321. e-mail address correctly first.
  322.  
  323.  
  324.  
  325. Where to get the latest ArcWeb
  326. ==============================
  327.  
  328. The very latest version is always available from ftp.dsse.ecs.soton.ac.uk
  329. in directory /pub/Acorn/ArcWeb/   This archive can also be reached (and
  330. preferably so) at http://ftp.dsse.ecs.soton.ac.uk:8080/ftp/ArcWeb/
  331.  
  332. The latest stable official release is also available for FTP from:
  333.  
  334. micros.hensa.ac.uk in /micros/arch/riscos/c/c135/
  335. ftp.demon.co.uk in /pub/acorn/www/ArcWeb/
  336.  
  337. The Acorn section of the HENSA/micros archive is now mirrored in the Demon
  338. /pub/mirrors/hensa directory.  It is also mirrored at ftp.uni-stuttgart.de. 
  339. See the fortnightly posting by Gerben Vos on comp.sys.acorn.announce for more
  340. details on archive sites and mirroring arrangements.
  341.  
  342. I highly recommend that you look at the ArcWeb home page (go to my home page
  343. [shown below] and follow the link to it) if you have already have http:
  344. capability, and that if you DON'T, get it running on local files first before
  345. attempting network access.  The supplied HTML files contain descriptions of
  346. how to configure the software.  You DO NOT NEED network access in order to
  347. read the local files.
  348.  
  349.  
  350. Known Bugs
  351. ==========
  352.  
  353. TEXTAREA elements are not handled properly, because the size is limited to
  354. that given in the HTML definition (which should only refer to the visual
  355. characteristics of the area, not its actual maximum dimensions).
  356.  
  357. If you change mode whilst windows are iconised, they will reappear.
  358.  
  359.  
  360. Support
  361. =======
  362.  
  363. Bugs and comments should be sent to:  S.N.Brodie@ecs.soton.ac.uk
  364. please.  I cannot guarantee to respond to all mails, and I cannot
  365. guarantee to fix any bugs or add requested features, but all mail
  366. is read (eventually) and MAY be replied to.  Please remember to
  367. include the RAM:$.WebRegs file if reporting a bug that resulted in
  368. "ArcWeb has suffered a fatal internal error ..." kind of error.
  369. Detailed instructions on how to make ArcWeb produce this file may be
  370. found in the page linked to from the default page.  All you have
  371. to do is type "*Set DumpRegisters 1" at a command line prompt (in
  372. a TaskWindow or at the F12 prompt, for example) *before* running 
  373. ArcWeb.
  374.  
  375. Telephone support is NOT available.
  376.  
  377.  
  378. Other Information
  379. =================
  380.  
  381. Information, including known bugs and future enhancements, can be found at
  382. http://www.ecs.soton.ac.uk/~snb94r/arcweb/
  383.  
  384. My HTML base line specification document is RFC 1866: "HyperText Markup
  385. Language- 2.0"   Berners-Lee, Connolly, November 1995. ArcWeb is a conforming
  386. level 2 HTML application. Features that are part of the HTML 3.2, "Wilbur"
  387. and/or HTML 4.0 "Cougar" may or may not be supported at this time - some
  388. currently are, some aren't.
  389.  
  390. My base line specification document for HTTP is RFC2068 (HTTP/1.1 proposed
  391. standard).  ArcWeb also implements the standards track RFC2109 (HTTP State
  392. Management)
  393.  
  394. If you find this product useful then I am always happy to accept any
  395. donations you may wish to send to me.  Alternatively, if you prefer,
  396. you could donate some money to a local children's charity or hospice.
  397. (There is no obligation to do either of these)
  398.  
  399. ==
  400. Stewart Brodie
  401. S.N.Brodie@ecs.soton.ac.uk
  402.  
  403. (Until *September 1997* only!  I shall make known a new e-mail
  404.  address in due course.)
  405.